home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmRenderTableAddRenditions.z / XmRenderTableAddRenditions
Encoding:
Text File  |  2002-10-03  |  6.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss((((UUUU3333NNNNXXXXIIII))))XXXX SSSSyyyysssstttteeeeXXXXmmmmmmmmRRRRVVVVeeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss - Creates a new render table
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/Xm.h>
  13.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss(
  14.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee oooollllddddttttaaaabbbblllleeee,
  15.           XXXXmmmmRRRReeeennnnddddiiiittttiiiioooonnnn ****rrrreeeennnnddddiiiittttiiiioooonnnnssss,
  16.           CCCCaaaarrrrddddiiiinnnnaaaallll rrrreeeennnnddddiiiittttiiiioooonnnn____ccccoooouuuunnnntttt,
  17.           XXXXmmmmMMMMeeeerrrrggggeeeeMMMMooooddddeeee mmmmeeeerrrrggggeeee____mmmmooooddddeeee);
  18.  
  19.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  20.           This page documents Motif 2.1.
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss is a function to create a new
  24.           render table that includes the renditions listed in
  25.           _o_l_d_t_a_b_l_e, if there is one. This function also copies
  26.           specified renditions (_r_e_n_d_i_t_i_o_n_s) to the new render table.
  27.           The first _r_e_n_d_i_t_i_o_n__c_o_u_n_t renditions of the _r_e_n_d_i_t_i_o_n_s array
  28.           are added to the new table. If a rendition is tagged with a
  29.           tag that matches a tag already in _o_l_d_t_a_b_l_e, then the
  30.           existing rendition using that tag is either modified or
  31.           freed and replaced with the new rendition, depending on the
  32.           value of _m_e_r_g_e__m_o_d_e. If _o_l_d_t_a_b_l_e is NULL,
  33.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss creates a new render table
  34.           containing only the specified renditions.
  35.  
  36.           This function deallocates the original render table after
  37.           extracting the required information. It is the
  38.           responsibility of the caller to free the renditions of the
  39.           _r_e_n_d_i_t_i_o_n_s array by calling the XXXXmmmmRRRReeeennnnddddiiiittttiiiioooonnnnFFFFrrrreeeeeeee function.
  40.  
  41.           _o_l_d_t_a_b_l_e  Specifies the render table to be added to.
  42.  
  43.           _r_e_n_d_i_t_i_o_n_s
  44.                     Specifies an array of renditions to be added.
  45.  
  46.           _r_e_n_d_i_t_i_o_n__c_o_u_n_t
  47.                     Specifies the number of renditions from _r_e_n_d_i_t_i_o_n_s
  48.                     to be added.
  49.  
  50.           _m_e_r_g_e__m_o_d_e
  51.                     Specifies what to do if the XXXXmmmmNNNNttttaaaagggg of a rendition
  52.                     matches that of one that already exists in
  53.                     _o_l_d_t_a_b_l_e. The possible values are as follows:
  54.  
  55.                     XXXXmmmmMMMMEEEERRRRGGGGEEEE____RRRREEEEPPPPLLLLAAAACCCCEEEE
  56.                               Completely replaces the old rendition
  57.                               with the new one.
  58.  
  59.                     XXXXmmmmMMMMEEEERRRRGGGGEEEE____OOOOLLLLDDDD
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss((((UUUU3333NNNNXXXXIIII))))XXXX SSSSyyyysssstttteeeeXXXXmmmmmmmmRRRRVVVVeeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeAAAAddddddddRRRReeeennnnddddiiiittttiiiioooonnnnssss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                               Replaces any unspecified values of the
  75.                               old rendition with the corresponding
  76.                               values from the new rendition.
  77.  
  78.                     XXXXmmmmMMMMEEEERRRRGGGGEEEE____NNNNEEEEWWWW
  79.                               Replaces the old rendition with the new
  80.                               rendition, replacing any unspecified
  81.                               values of the new rendition with the
  82.                               corresponding values from the old
  83.                               rendition.
  84.  
  85.                     XXXXmmmmSSSSKKKKIIIIPPPP    Skips over the new rendition, leaving
  86.                               the old rendition intact.
  87.  
  88.      RRRREEEETTTTUUUURRRRNNNN
  89.           If _r_e_n_d_i_t_i_o_n_s is NULL or _r_e_n_d_i_t_i_o_n__c_o_u_n_t is 0 (zero), this
  90.           function returns _o_l_d_t_a_b_l_e.  Otherwise, the function returns
  91.           a new XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee.  The function allocates space to hold
  92.           this new render table.  The application is responsible for
  93.           managing this allocated space.  The application can recover
  94.           the allocated space by calling XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeFFFFrrrreeeeeeee.
  95.  
  96.      RRRREEEELLLLAAAATTTTEEEEDDDD
  97.           XXXXmmmmRRRReeeennnnddddiiiittttiiiioooonnnn(3) and XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeFFFFrrrreeeeeeee(3).
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.